home *** CD-ROM | disk | FTP | other *** search
/ MacWorld 1998 October / Macworld (1998-10).dmg / Shareware World / Utilities / Disk & File / CDFinder 2.1.1 / CDFinder Read me! < prev    next >
Text File  |  1997-07-24  |  16KB  |  240 lines

  1. Dedicated to my father (1922-1997).
  2.  
  3. Welcome to CDFinder!
  4. By Norbert M. Doerner
  5.  
  6.  
  7. About CDFinder
  8. This easy-to-use and fast application creates catalog files of CD-ROMs, hard disks, floppies, ZIPs and almost everything that spins.  Using the powerful search functions you can easily locate and display files or folders.
  9.  
  10. For more information, please launch CDFinder and select "CDFinder Help" in the "Help" menu. A detailed list explaining the improvements of this new version can be found at the end of this document.
  11.  
  12. While reading this document please keep in mind that English is not my native language. Nevertheless I hope that the translation is acceptable.
  13.  
  14.  
  15. System requirements
  16. CDFinder needs System 7.0  or newer and at least a 68020-CPU or a Power-Mac. Since it also uses Color QuickDraw, it can't run on any of the older Mac Plus, SE, Classic and the PowerBook 100.
  17. I did my tests on many different Power Macs, native and using the 68k emulation.
  18. CDFinder is fully compatible to MacOS 8 and 8.1!
  19.  
  20. If drag&drop is installed, the application uses it in some parts (see below).
  21.  
  22.  
  23. Limitations
  24. The unregistered version of CDFinder will annoy you at every launch with a little dialog reminding you of the benefits of paying your shareware fee. The number of catalogs is also reduced to 25, which is surely enough to evaluate the application and its functions.
  25.  
  26.  
  27. Registration
  28. CDFinder has the following pricing:
  29. 1- 10 single user licenses, $15 per user
  30. 11-24 single user licenses, $12 per user
  31. 25-49 single user licenses, $10 per user
  32. 50+ single user licenses, $8 per user
  33.  
  34. A Site License costs $500 (roughly equal to 50 users) and covers all locations for your organization within a 160 kilometer radius of your site (100 miles). One big advantage of a Site License is that you do not need to keep track of how many people at your site are using the software. 
  35.  
  36. A World-Wide License costs $2000 and it covers all locations for your organization on the planet earth.
  37.  
  38. For additional $5 I will send you a floppy disk containing the most recent version of the program (by airmail, if possible).
  39.  
  40. Updates are free and can be obtained at the CDFinder-Homepage: http://people.frankfurt.netsurf.de/nmd/index.html
  41.  
  42.  
  43. Payment directly to the author (Cash only!)
  44. You can pay Cash by simply adding the money to your registration form. This works quite well if the envelope is made of thick paper. I do also accept cash in different currencies, please contact me! You can either use the SimpleText document enclosed with CDFinder as a registration form or use the "Registration Form" command found in the "Special" menu in CDFinder.
  45.  
  46. My postal address is:
  47.  
  48. Norbert M. Doerner
  49. Tannenstraße 2
  50. 63867 Johannesberg
  51. Germany
  52.  
  53. If you fill in your registration form without using the dialog provided by CDFinder, please print carefully. My brand new biological character recognition system (BRAIN 3.0) still needs some training ;-)
  54.  
  55. Due to very popular demand, payment is now also possible by using the great Kagi service!
  56.  
  57.  
  58. Payment via Kagi (anything else...)
  59. Just open the Register program that accompanies CDFinder. Enter your name, your email address, and the number of single user licenses you desire (or Site or Word-Wide licenses). Save or Copy or Print the data from the Register program and send the data and payment to Kagi. Kagi handles my payment processing.
  60.  
  61. If paying with Credit Card or First Virtual, you can email or fax the data to Kagi. Their email address is sales@kagi.com and their fax number is +1 510 652-6589. You can either Copy the data from Register and paste into the body of an email message or you can Save the data to a file and you can attach that file to an email message. There is no need to compress the data file, it's already pretty small. If you have a fax modem, just Print the data to the Kagi fax number. 
  62.  
  63. Payments sent via email are processed by Kagi within a week. You will receive an email acknowledgement when it is processed. Payments sent via fax take up to 20 days and if you provide a correct internet email address you will receive an email acknowledgement. If you require a written receipt, please keep in mind that even by airmail it might take a week for a letter to arrive.
  64. After you receive the acknowledgement by Kagi, I will send you the key as soon as possible. Please keep in mind that CDFinder is not my full-time job, so it could be 7 or even 12 days until you receive your key from me. Usually it will only take two or three days.
  65.  
  66. If you are paying with Cash or USD Check you should print the data using the Register application and send it to the address shown on the form, which is: 
  67.  
  68.               Kagi
  69.               1442-A Walnut Street #392-1UJ
  70.               Berkeley, California 94709-1405
  71.               USA
  72.  
  73.  
  74. You can pay with a wide variety of cash from different countries but at present if you pay via check, it must be a check drawn in US Dollars. Kagi cannot accept checks in other currencies, the conversion rate for non-USD checks is around USD 15 per check and that is just not practical.
  75.  
  76. If you have a purchasing department, you can enter all the data into the Register program and then select Invoice as your payment method. Print three copies of the form and send it to your accounts payable people. You might want to highlight the line that mentions that they must include a copy of the form with their payment.  Kagi can not invoice your company, you need to act on my behalf and generate the invoice and handle all the paperwork on your end. 
  77.  
  78. Please do not fax or email payment forms that indicate Cash, Check or Invoice as the payment method. As far as we know, there is still no technology to transfer physical objects via fax or email and without the payment, the form cannot be processed.
  79.  
  80. Payments send via postal mail take time to reach Kagi and then up to 10 days for processing. Again, if you include a correct email address, you will hear from Kagi when the form is processed.
  81.  
  82.  
  83.  
  84. Protection
  85. CDFinder has a protection scheme and when you pay, I tell you how to indicate to CDFinder that you have paid the registration fee. If you do not have an email address, please enter your complete postal address and please remember, I do not know what country you live in so please enter that into the postal address also. 
  86.  
  87. If you pay by sending me cash directly to Germany, I will send you your personal registration keyword by snail mail (airmail!) too.
  88.  
  89.  
  90.  
  91. Legal stuff
  92. CDFinder is shareware.
  93.  
  94. The application "CDFinder" and all included materials are protected by copyright law. You may not disassemble it or modify it with similar tools.
  95.  
  96. You may copy the program together with all additional documents as often as you want, as long as you don't modify any part of it! You may not sell it or use it commercially in any other way without my written consent.
  97.  
  98. If you want to distribute CDFinder on a shareware collection CD-ROM or anything like that, simply inform me with an e-mail or a written letter. I'd also like to have a copy of the CD-ROM, if possible...
  99.  
  100. For a trial period of 30 days you may freely use the program. After that, you need to register it.
  101.  
  102. In absolute no way am I responsible for any damage occurring by the use of the software. 
  103.  
  104.  
  105.  
  106. Contacting the author
  107. Just send me e-mail to
  108. Doerner@kagi.com
  109.  
  110. My postal address:
  111.  
  112. Norbert M. Doerner
  113. Tannenstrasse 2
  114. 63867 Johannesberg
  115. Germany
  116.  
  117.  
  118.  
  119. The story
  120. The whole thing started on one of those days that found me frantically searching my zillions of floppies and CD-ROMs for one particular file. Of course, I just found it on the last possible volume.
  121.  
  122. After this enlightening event I decided to search my huge software collection for a suitable cataloging tool. Most unfortunately, my search turned out empty.
  123.  
  124. Some of the tools I found required system extensions - which I do not like very much. One even created alias files of the contents of the CD-ROMs, a stupid behavior if you have some million files on several disks (the Mac OS does not like that!). Some programs were simply too slow or did puke at large CD-ROMs. Some expensive commercial applications were not native or would not run in the background. All of the tools didn't even support drag&drop!
  125.  
  126. So I made up my mind and started my own little project. Since some of my friends were quite positive about my ideas, I decided to put the results into a shareware program called "CDFinder". The application should be easy to use, very fast, support drag&drop, work in the background and include powerful search tools.
  127. And here it is!!
  128.  
  129.  
  130. System requirements
  131. CDFinder needs System 7.0  or newer and at least a 68020-CPU or a Power-Mac. Since it also uses Color QuickDraw, it can't run on any of the older Mac Plus, SE, Classic and the PowerBook 100. I did my tests on many different Power Macs, native and using the 68k emulation. If you have drag&drop installed, the application uses it in some parts (see "Help").
  132.  
  133.  
  134. Theory of operation
  135. CDFinder displays every known catalog in its main window. You can sort the content by name, size, or label. By changing the name of a catalog, you can influence the sort order for a given catalog (put a space in front of the name to let it appear right on top, if you sort by name).
  136. Using drag&drop (if installed) or "Create Catalog…", you can create a new catalog of a volume. To create lots of catalogs at once, try using "Batch Create…", which will eject any volume afterwards.
  137. To display the content of a catalog, simply double click it or select it and press "return". To obtain more information about any catalog or any object inside a catalog, simply use "Information".
  138.  
  139. But what is a bunch of catalogs without the ability to search them? Nothing! That's why you should take a very close look at the window "Find…". It will allow you to enter the type and content of information you look for, and also narrow the range by including only catalogs with a selected label to the search. You can even search just the found objects!
  140.  
  141.  
  142. Performance
  143. CDFinder is absolutely optimized for the PowerPC processor but runs very fast on the "older" Macs as well. Another positive aspect is the simple fact that you can move the program into the background during time consuming processes to work with other things.
  144. However, CDFinder must handle a real big amount of data, just go and check the size of your catalog folder! A very simple way to improve the performance is to increase the memory partition of CDFinder. Please note that increasing the file system cache using the control panel "Memory" will have no valuable effect at all, on the contrary. CDFinder is using it's own sophisticated caching mechanism that simply knows more about the state and importance of the data than the file system.
  145.  
  146.  
  147. Special things...
  148. Since CDFinder is basically designed to handle huge amounts of huge CD-ROMs and other volumes whose contents will not change at all or only very seldom, the program does not check if anything changes on a volume while the catalog is being created. This can lead to some problems if the volume is in fact changed, which is quite likely to occur for file server volumes. In that case, the content of the catalog may not be identical to the content of the volume.
  149.  
  150. Due to the nature of the current MacOS file system, CDFinder cannot catalog more than 32,000 items inside a single folder. Since you theoretically could create such folders, any items after the first 32,000 will be ignored.
  151.  
  152. It is possible to change the name of a catalog by using the "Information" window. You can also add a comment, which is displayed (the first line only) in the main window if you have selected that column in the preferences window (panel "Appearance").
  153.  
  154.  
  155.  
  156. History
  157.  
  158. The most actual version is available at the Info-Mac archives and the CDFinder-Homepage at:
  159. http://people.frankfurt.netsurf.de/nmd/index.html
  160. If you use Internet Config, you can also open the "About CDFinder…" dialog and simply click inside the http address!
  161.  
  162. 2.1.1 (July 24, 1998)
  163. - Support for the new Navigation Services! If you press the “Alt” key, you will have the old dialogs.
  164. - CDFinder now keeps the location of your catalog folder in an alias. The big advantage is a better reliability and the fact that CDFinder can now mount any server volume for you that contains your catalog folder!
  165. - The CDFinder cache is now much more effective, causing a much faster launch for all of you folks with multi-user licenses!
  166. - Support for the control panel "SmartScroll" with proportional scroll bars.
  167. - Balloon help for menus (English, Italian, and German only).
  168. - Faster display routines for list displays.
  169. - The “Find” dialog now uses other text input routines.
  170. - To communicate with the Finder , CDFinder no longer uses AppleScript, but direct Apple Events.
  171. - The contents of the “Help” window can now be printed.
  172. - Some CDFinder windows now deactivate their control items when in background. 
  173. - The "New Catalog Folder" dialog now defaults to a more intelligent name.
  174. - Many Thanks to Erik Ekengren for the Swedish translation!!
  175. - Many Thanks to John Zetlaoui for an improved French translation!
  176. - If CDFinder cannot find your catalog folder at launch, it will now bring up a dialog explaining that and let you choose a new folder or show CDFinder the new location of your folder.
  177. - A real lot of minor and even some major bugs have been fixed!
  178.  
  179. 2.1 (March 12,1998)
  180. - Finally! The content of catalog windows can now be sorted and even the sort order may be changed!
  181. - It is possible to create a new catalog directly inside a catalog folder by dropping the volume icon into the folder.
  182. - The "Get Info" window for a folder inside a catalog now displays the size and number of all enclosed items.
  183. - When renaming a catalog, CDFinder now also renames the catalog file accordingly.
  184. - The user interface now not only "speaks" Italian (many thanks to Giorgio Boccalari!!!), but the French translation was also improved and extended (Thanks to Doris Wagner, Giorgio Boccalari and John Zetlaoui!!).
  185. - CDFinder now remembers if the "Find" window was open.
  186. - The "Page Setup" settings are now saved.
  187. - The drag&drop area inside the "Find" window is now larger.
  188. - Zooming of windows is much more intelligent.
  189. - System extensions and control panels are now recognized as file types.
  190. - A real lot of minor and even major bugs have been fixed!
  191.  
  192.  
  193. If you want to know more about the other older versions of CDFinder, be sure to visit the CDFinder-Homepage.
  194.  
  195.  
  196. The undiscovered country
  197. I am planning the following improvements for the next releases of CDFinder:
  198. - Selecting more than one item at once (version 2.2!)
  199. - Adjusting column widths  (maybe also in 2.2!)
  200. - Folders in catalogs might be opened inside the window (just like the Finder does!)
  201. - A much improved help system.
  202. - Finding duplicates
  203. - Automatically updating catalogs
  204.  
  205. But this has yet to be discovered and everything depends on how much time I will be able to spare :-))
  206.  
  207.  
  208.  
  209. Acknowledgements
  210. First of all I would like to thank my wonderful wife Silvia. Without her patience, the development process would not have been possible.
  211.  
  212. I also want to thank all of those who helped me doing the first beta testing and thereby provided invaluable assistance checking the functions and user interface of the software: Wolfgang Warmbold, Martin Girschick, Patrick Röder, Michael Stunz, Manfred Kunkel, Ralf Schlobinski, Heiko and Manfred Richter.
  213.  
  214. Of course, without all of your registrations, I might have ceased development years ago! Thank you very much!!
  215.  
  216. The comments and notes of all registered users also helped a lot.
  217.  
  218. Without the help and the support of the following people, CDFinder would surely be a lesser tool now: Erik Ekengren, Doris Wagner, Giorgio Boccalari, John Zetlaoui, David C. Oshel und Thomas v. Landsberg-Velen. Thank you very much!!!
  219.  
  220. Please send me ideas, comments, notes and Cocoa Puffs or Star Trek books! 
  221.  
  222. Just send me e-mail:
  223.  
  224. Doerner@kagi.com
  225.  
  226. My postal address:
  227.  
  228. Norbert M. Doerner
  229. Tannenstrasse 2
  230. 63867 Johannesberg
  231. Germany
  232.  
  233.  
  234.  
  235. By Norbert M. Doerner 1998
  236. © Copyright by West-Forest-Systems 1998
  237.  
  238. Do you believe in Macintosh? Please check out 
  239. <http://www.evangelist.macaddict.com/> and join the EvangeList mailing 
  240. list by sending an email to <evangelist@macway.com>.